package com.nidu.demo.dict.gateway;

import com.alibaba.cola.dto.PageResponse;
import com.nidu.demo.dict.model.DictData;
import com.nidu.demo.dict.model.DictDataCriteria;

import java.util.Set;
import java.util.List;

/**
 * 字典数据网关接口
 * 提供领域层对字典数据的访问能力
 *
 * @author auto
 */
public interface DictDataGateway {

    /**
     * 创建字典数据
     *
     * @param dictData 字典数据信息
     * @return 创建后的字典数据
     */
    DictData create(DictData dictData);

    /**
     * 更新字典数据
     *
     * @param dictData 字典数据信息
     * @return 更新后的字典数据
     */
    DictData update(DictData dictData);

    /**
     * 根据ID查询字典数据
     *
     * @param id 字典数据ID
     * @return 字典数据信息
     */
    DictData getById(Long id);

    /**
     * 根据字典类型和值查询字典数据
     *
     * @param dictType 字典类型
     * @param value 字典值
     * @return 字典数据信息
     */
    DictData getByTypeAndValue(String dictType, String value);

    /**
     * 删除字典数据
     *
     * @param id 字典数据ID
     */
    void deleteById(Long id);

    /**
     * 批量删除字典数据
     *
     * @param ids 字典数据ID列表
     */
    void deleteByIds(Set<Long> ids);

    /**
     * 查询字典数据列表
     *
     * @param criteria 查询条件
     * @return 字典数据列表
     */
    List<DictData> listByCondition(DictDataCriteria criteria);

    /**
     * 分页查询字典数据
     *
     * @param criteria 查询条件
     * @return 分页结果
     */
    PageResponse<DictData> pageByCondition(DictDataCriteria criteria);

}
